Inside Macintosh: QuickDraw GX Printing Extensions and Drivers /

Chapter 4 - Printing Messages / Printing Messages Reference

Printing Messages / Compatibility Messages

GXPrJobDialog

QuickDraw GX sends the GXPrJobDialog message when an application that supports the Macintosh Printing Manager calls the PrJobDialog function. You can override the GXPrJobDialog message to customize the handling of the PrJobDialog function. Your override of the GXPrJobDialog message must match the following formal declaration:

OSErr MyPrJobDialog (THPrint aTHPrint, Boolean *aBoolean);

aTHPrint

A handle to the print record for this printing operation.

aBoolean

On return, a Boolean value that is true if the user confirmed the dialog box and false if not.

function result

An error code. The value noErr indicates that the operation was successful.

DESCRIPTION

The default implementation of the GXPrJobDialog message looks for dialog ('DLOG'), item list ('DITL'), and dialog control ('dctl') resources that have the ID -8191 in
your driver resources. If QuickDraw GX does not find resources with this ID, it uses its own default resources to construct and display a Print dialog box. Some of the values displayed in the Print dialog box are controlled by the customization ('cust') resource.

You can override this message to add any special handling that your driver requires with regard to print quality, range of pages, and other properties associated with a print object.

SPECIAL CONSIDERATIONS

You never send the GXPrJobDialog message yourself.

You almost always forward the GXPrJobDialog message so that the default implementation can perform its operations.

RESULT CODES

gxSegmentLoadFailedErr	A required code segment could not be found, or there was not enough memory to load it.
gxPrUserAbortErr	The user has canceled printing.

SEE ALSO

The PrJobDialog function is described in Inside Macintosh: Imaging With QuickDraw.

The dialog control and customization resources are described in the chapter "Printing Resources" in this book.

The dialog and item list resources are described in Inside Macintosh: Macintosh Toolbox Essentials.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help